home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
TPUG - Toronto PET Users Group
/
TPUG Users Group CD
/
TPUG Users Group CD.iso
/
CRS
/
crs11.d81
/
kermdocs.lnx
/
kermit 2.doc.seq
< prev
next >
Wrap
Text File
|
2009-10-10
|
13KB
|
463 lines
├-64/128 ╦ERMIT ╒SER'S ╟UIDE ╨AGE 3
╘UTORIAL: ╔NTRODUCTION TO ╦ERMIT
┬OOTING ╦ERMIT
╦ERMIT IS WRITTEN FOR THE ├OMMODORE 64 AND 128 (IN 64 MODE).
╧NE ├OMMODORE DISK DRIVE (OR COMPATIBLE) IS REQUIRED, AND A
MODEM. ┴LMOST ANY MODEM WILL WORK EXCEPT THE ├OMMODORE
1660. ╘O BOOT ╦ERMIT, FOLLOW THESE EASY STEPS:
╞OR ├OMMODORE 64:
1. ╘URN ON MONITOR, DRIVE, AND COMPUTER.
2. ╔NSERT THE ╦ERMIT DISK, LABEL SIDE UP, INTO DEVICE 8,
DRIVE 0, AND CLOSE THE DRIVE DOOR.
3. ╘YPE: ╠╧┴─ ""┬╧╧╘"",8,1 AND PRESS <╥┼╘╒╥╬>.
╞OR ├OMMODORE 128:
1. ╔NSERT THE ╦ERMIT DISK, LABEL SIDE UP, INTO DEVICE 8,
DRIVE 0, AND CLOSE THE DRIVE DOOR.
2. ╘URN ON THE MONITOR, DRIVE, AND COMPUTER.
3. ╦ERMIT WILL AUTOMATICALLY BOOT ON POWER-UP.
╧NCE LOADED, YOU SHOULD SEE THE FOLLOWING IN BLACK ON A GREY
SCREEN WITH A BLUE BORDER:
├OMMODORE 64/128 ╦ERMIT VERSION 2.2 (73)
╘YPE '?' FOR HELP
╦ERMIT-65>
┴ BLINKING BLOCK CURSOR SHOULD BE JUST TO THE RIGHT OF THE
">". ╔F YOU DON'T SEE THIS ON YOUR SCREEN, TURN OFF ALL
YOUR EQUIPMENT AND TRY AGAIN. ╔F YOU STILL HAVE PROBLEMS
BOOTING ╦ERMIT, PLEASE SEE THE ╘ROUBLESHOOTING SECTION.
├HOOSING A ╙CREEN ─RIVER
╦ERMIT CAN USE MANY KINDS OF DISPLAYS. ┘OU CAN USE EITHER
40 COLUMNS OR 80 COLUMNS (SOFTWARE-DRIVEN) ON A STANDARD ├-
64, OR, IF YOU HAVE A ┬ATTERIES ╔NCLUDED ┬╔-80 80-COLUMN
CARD, YOU CAN USE IT TOO. ┴LL OF THESE OPTIONS ARE AVAIL-
ABLE ON A ├-128, PLUS THE ├-128'S BUILT-IN 80-COLUMN
DISPLAY. ╦ERMIT DEFAULTS TO THE SETTING FOUND IN ITS INI-
TIALIZATION FILE.
┼ACH OF THE SCREEN DRIVERS HAS ITS ADVANTAGES AND DISADVAN-
TAGES. ╬OT ALL OF THE DRIVERS, FOR EXAMPLE, ARE CAPABLE OF
SUPPORTING FEATURES SUCH AS UNDERLINING OR BOLD. ╨LEASE SEE
THE ╙CREEN ─RIVER ├OMPARISON SECTION FOR FURTHER DETAILS.
╨AGE 4 ├-64/128 ╦ERMIT ╒SER'S ╟UIDE
╔F YOU WANT TO SWITCH TO A DIFFERENT SCREEN DRIVER NOW,
PLEASE SEE THE EXAMPLE GIVEN IN THE ├OMMAND ═ODE SECTION
BELOW.
╘HE ╘HREE ═ODES OF ╦ERMIT
╦ERMIT HAS THREE BASIC OPERATIONAL MODES: ├OMMAND, ├ONNECT,
AND ╞ILE-╘RANSFER. ╔N ├OMMAND MODE, YOU CAN COMMUNICATE
DIRECTLY WITH ╦ERMIT TO CHANGE VARIOUS PROGRAM SETTINGS AND
ALSO ENTER EITHER OF THE TWO OTHER MODES. ╔N ├ONNECT MODE
YOU CAN COMMUNICATE WITH ANOTHER COMPUTER (KNOWN IN MANY
OTHER TERMINAL PROGRAMS AS ╘ERMINAL MODE). ╔N ╞ILE-╘RANSFER
MODE YOU MAY SEND TO AND RECEIVE FILES FROM THE COMPUTER TO
WHICH YOU ARE CONNECTED. ╠ET'S BEGIN BY LEARNING ABOUT ├OM-
MAND MODE AND THE ╦ERMIT PARSER.
├OMMAND ═ODE
╫HEN ╦ERMIT FIRST BOOTS, YOU ARE PLACED AUTOMATICALLY IN
├OMMAND MODE. ╞ROM HERE YOU CAN COMMUNICATE WITH THE PRO-
GRAM BY TYPING COMMANDS AT THE "╦ERMIT-65>" PROMPT. ├OMMAND
MODE IS REALLY THE PROGRAM'S COMMAND "PARSER", WHICH IS THAT
PART OF A COMPUTER PROGRAM WHICH TAKES YOUR COMMAND INPUT
AND TRIES TO INTERPRET IT AND THEN EXECUTE THE APPROPRIATE
ACTION.
╦ERMIT'S COMMAND PARSER IS VERY EASY TO USE. ╠ET'S BEGIN
WITH A LOOK AT THE MAIN LEVEL COMMANDS. ┴T THE TOP OF THE
SCREEN YOU SHOULD SEE "╘YPE '?' FOR HELP". ╙O LET'S DO JUST
THAT: ╘YPE A "?". ┴ LIST OF ╦ERMIT'S MAIN COMMANDS (THERE
ARE 16 OF THEM) SHOULD APPEAR ON THE SCREEN IN TWO COLUMNS
LIKE THIS:
╦ERMIT-65>? ╦EYWORD, ONE OF THE FOLLOWING:
BYE CONNECT
DIRECTORY DISK
EXIT FINISH
GET HELP
QUIT RECEIVE
RESTORE SAVE
SEND SET
SHOW STATUS
╘HE "?" IS A VERY HELPFUL FEATURE OF THE COMMAND PARSER.
┘OU CAN TYPE A "?" AT ┴╬┘ POINT IN THE MIDDLE OF A COMMAND
TO RECEIVE A LIST OF THE VALID WAYS TO COMPLETE THE COMMAND.
┴ COMPLETE LIST OF COMMANDS MAY BE FOUND IN THE ├OMMAND
─ESCRIPTIONS SECTION.
╠ET'S TRY A SLIGHTLY MORE DIFFICULT COMMAND TO GIVE YOU
PRACTICE WITH THE PARSER. ╞OR EXAMPLE, LET'S SAY WE WANT TO
├-64/128 ╦ERMIT ╒SER'S ╟UIDE ╨AGE 5
CHANGE WHICH SCREEN DISPLAY WE ARE USING. ┴FTER LOOKING AT
THE VARIOUS MAIN LEVEL COMMANDS, WE DEDUCE THAT THE ╙┼╘ COM-
MAND MIGHT BE THE WAY TO GET THE JOB DONE. ╘YPE: ╙┼╘ FOL-
LOWED BY A SPACE AND THEN A "?". ╦ERMIT SHOULD RESPOND WITH
A LIST THAT LOOKS LIKE THIS:
╦ERMIT-65>SET ? ╦EYWORD, ONE OF THE FOLLOWING:
BAUD BOLD
BORDER CHARACTER
DARK-BACKGROUND DEBUGGING
EIGHT-BIT-QUOTING ESCAPE
FILE-BYTE-SIZE FILE-TYPE
FILE-WARNING FLOW-CONTROL
IBM LIGHT-BACKGROUND
LOCAL-ECHO PARITY
RECEIVE RS232-REGISTERS
SEND SCREEN-DRIVER
TERMINAL-EMULATION WORD-SIZE
┴FTER LOOKING THROUGH THIS LIST, WE CAN DETERMINE WE NEED
THE ╙├╥┼┼╬-─╥╔╓┼╥ SUB-OPTION. ╬OTICE THAT THE PARSER CON-
VENIENTLY REPRINTED THE ╙┼╘ COMMAND SO THAT WE CAN CONTINUE
WHERE WE LEFT OFF. ╙O, TYPE: ╙├╥┼┼╬-─╥╔╓┼╥ FOLLOWED BY A
SPACE AND A "?". ╬OW WE HAVE ANOTHER LIST, LOOKING LIKE
THIS:
╦ERMIT-65> SET SCREEN-DRIVER ? ╦EYWORD, ONE OF THE FOLLOWING:
40-COLUMNS 80-COLUMNS
BI-80 COMMODORE-128
CUSTOM-BI-80
╔T SHOULD NOW BE OBVIOUS WHAT TO DO TO CHANGE TO A DIFFERENT
SCREEN DRIVER. ╘RY IT OUT. ╬OW, LET'S GO BACK TO 80
COLUMNS.
╧NE THING YOU ARE PROBABLY WONDERING IS, "─O ╔ HAVE TO TYPE
┴╠╠ OF THAT OUT?" ╠UCKILY, NO, YOU DON'T. ╘HE LEFT ARROW
KEY (UPPER LEFT CORNER OF THE KEYBOARD) IS THE "┼SCAPE" KEY
IN ╦ERMIT. ╘HIS KEY WILL SPELL OUT A COMMAND ONE LEVEL AT A
TIME FOR YOU IF YOU PROVIDE IT WITH THE FIRST FEW CHARACTERS
OF THE COMMAND. ╬OTE: IF YOU ARE USING A ├-128, YOU CAN
ALSO USE <┼╙├>. ╘O TRY THIS OUT, TYPE: ╙┼╘ ╙├ AND HIT THE
LEFT ARROW KEY. ╦ERMIT SHOULD SPELL OUT ╙├╥┼┼╬-─╥╔╓┼╥ AND
PUT A SPACE AT THE END. ╬OTICE THAT WE HAD TO USE "SC" AND
NOT JUST "S". ├ONSULTING THE LIST ABOVE, WE CAN SEE WHY.
┬OTH ╙┼╬─ AND ╙├╥┼┼╬-─╥╔╓┼╥ BEGIN WITH AN "S". ╔F WE HAD
JUST TYPED "S", ╦ERMIT WOULD HAVE CHOSEN ╙┼╬─ BECAUSE IT IS
THE FIRST COMMAND IN THE LIST THAT MEETS THE SPECIFIED
REQUIREMENTS. ╘HE SAME APPLIES FOR WHY WE SPELLED OUT ╙┼╘.
╙┼╬─ IS BEFORE ╙┼╘ IN THE MAIN COMMAND LIST, MAKING THE LEFT
ARROW USELESS. ╙O KEEP IN MIND THAT YOU MUST ALWAYS USE
╨AGE 6 ├-64/128 ╦ERMIT ╒SER'S ╟UIDE
ENOUGH CHARACTERS TO UNIQUELY IDENTIFY THE COMMAND BEFORE
HITTING THE LEFT ARROW. ╧K, LET'S FINISH OUR COMMAND. ╘YPE
"8" AND HIT THE LEFT ARROW. ╦ERMIT SHOULD FINISH THE COM-
MAND. ╬OW PRESS <╥┼╘╒╥╬>.
╨RESTO! ╫E'RE BACK TO 80-COLUMN MODE, SAVING 19 CHARACTER'S
WORTH OF TYPING. ╬OT ALL COMMANDS ARE NEARLY THIS LONG, BUT
THE LEFT ARROW (ALONG WITH THE "?") CAN BE VERY HELPFUL.
╬╧╘┼: ╧NCE YOU ARE FAMILIAR WITH THE PARSER, YOU CAN SAVE
EVEN MORE KEYSTROKES BY USING JUST THE ABBREVIATIONS FOR THE
COMMANDS. ╔N OTHER WORDS, YOU DON'T ╚┴╓┼ TO USE THE LEFT
ARROW KEY. ╞OR EXAMPLE, YOU COULD JUST TYPE "╙┼╘ ╙├ 8" TO
SET THE SCREEN DRIVER TO ├-64 80 COLUMNS.
╘HERE ARE A FEW OTHER USEFUL TRICKS TO KNOW ABOUT THE
PARSER. ╘HEY ARE:
1) ╨RESSING <├╠╥> OR <├╘╥╠> - <╠> INSTEAD OF <╥┼╘╒╥╬> TO
EXECUTE A COMMAND WILL CLEAR THE SCREEN FIRST AND THEN
EXECUTE THE COMMAND.
2) ╨RESSING <├╘╥╠> - <╫> WHILE TYPING A COMMAND WILL BACK
THE CURSOR UP TO THE PREVIOUS WORD, ERASING ANY ASSOCI-
ATED TEXT.
3) ╨RESSING <├╘╥╠> - <╒> WHILE TYPING A COMMAND WILL CAN-
CEL THE COMMAND BY BACKING THE CURSOR UP TO THE
"╦ERMIT-65>" PROMPT.
├ONNECT ═ODE
├ONNECT MODE IS THE MODE IN WHICH YOU WILL SPEND MOST OF
YOUR TIME WHILE USING ╦ERMIT BECAUSE IT IS IN THIS MODE THAT
YOU CAN COMMUNICATE WITH ANOTHER COMPUTER (OFTEN KNOWN AS
THE REMOTE HOST). ╬OW LET'S PREPARE TO CONNECT TO ANOTHER
COMPUTER. ╘YPE: ├╧╬╬┼├╘. ╘HIS COMMAND WILL TAKE US OUT OF
├OMMAND MODE AND INTO ├ONNECT MODE. ╔F YOU TYPE ├╧╬╬┼├╘
THEN HIT <├╠╥>, THE SCREEN WILL BE CLEARED BEFORE ENTERING
├ONNECT MODE. ┼VERY TIME YOU ENTER ├ONNECT MODE, YOU WILL
SEE THE MESSAGE:
[├ONNECTING TO HOST: ╘YPE ^┘ C TO RETURN]
╘HIS TELLS US THAT WE ARE IN ├ONNECT MODE AND THAT TO RETURN
TO ├OMMAND MODE WE SHOULD TYPE <├╘╥╠> - <┘> THEN TYPE "C".
╘RY IT OUT. ╘HEN RETURN TO ├ONNECT MODE.
╬OW WE WILL CALL THE OTHER COMPUTER. ┴ ├OMMODORE 1670 OR
OTHER ╚AYES COMPATIBLE MODEM CAN DIAL DIRECTLY FROM ├ONNECT
MODE VIA ITS BUILT-IN DIALING COMMANDS, BUT WITH MOST OTHER
MODEMS YOU WILL HAVE TO DIAL MANUALLY. ╔N OTHER WORDS, ╦ER-
MIT DOES ╬╧╘ HAVE THE CAPABILITY TO AUTO-DIAL A MODEM
├-64/128 ╦ERMIT ╒SER'S ╟UIDE ╨AGE 7
DIRECTLY. ┴LSO PLEASE NOTE THAT ╦ERMIT CURRENTLY DOES ╬╧╘
WORK WITH THE ├OMMODORE 1660 MODEM. ╔T WILL, HOWEVER, BE
SUPPORTED IN A FUTURE VERSION. ╨LEASE SEE ┴PPENDIX ┴:
╔MPLEMENTATION ╬OTES FOR FURTHER INFORMATION.
╫E NEED TO CHECK A FEW THINGS BEFORE DIALING. ┼ACH COMPUTER
YOU CONNECT TO MAY HAVE DIFFERENT BAUD, PARITY, AND WORD-
SIZE REQUIREMENTS. ╦ERMIT DEFAULTS TO THE SETTINGS FOUND IN
THE INITIALIZATION FILE: 1200 BPS TRANSMISSION SPEED, EIGHT
BIT WORD LENGTH, NO PARITY, AND ╓╘-100 TERMINAL EMULATION.
╘HESE SETTINGS MAY BE DIFFERENT IF YOU DID NOT GET YOUR COPY
OF ╦ERMIT FROM ─R. ┼VIL ╠ABS. ╘O ADJUST ANY OF THESE PARAM-
ETERS, ESCAPE BACK TO ├OMMAND MODE AND USE THE ╙┼╘ COMMAND
AS WE DID ABOVE TO CHANGE THE SCREEN-DRIVER. ╞OR EXAMPLE, TO
CHANGE TO 300 BPS TRANSMISSION SPEED, TYPE: ╙┼╘ ┬┴╒─ 300.
╥EMEMBER TO USE THE "?" TO GET HELP AT ANY LEVEL.
╔F YOU WISH TO SAVE ANY CHANGES YOU MAKE AS NEW DEFAULTS,
PLEASE SEE THE ╙┴╓┼ COMMAND EXPLANATION IN THE ├OMMAND
─ESCRIPTIONS SECTION.
╧NCE YOU HAVE SET UP YOUR COMMUNICATIONS PARAMETERS
CORRECTLY, ALL THAT'S LEFT TO DO IS DIAL THE PHONE AND CON-
NECT TO THE REMOTE HOST.
╞ILE-╘RANSFER ═ODE
╧NCE YOU HAVE CONNECTED TO A REMOTE HOST YOU MAY WISH TO
SEND AND/OR RECEIVE FILES. ╫ITH ╦ERMIT YOU CAN SEND AND
RECEIVE MOST ANY KIND OF FILE, AS ╦ERMIT HAS AUTOMATIC
TRANSLATION FEATURES FOR MANY TYPES OF FILES. ╞OR EXAMPLE,
YOU CAN AUTOMATICALLY CONVERT A ╨┼╘╙├╔╔ (├OMMODORE'S SPECIAL
┴╙├╔╔) TEXT FILE TO ┴╙├╔╔ WHEN SENDING IT TO ANOTHER
MACHINE, AND VICE VERSA. ╞OR A LIST OF THE VARIOUS FILE-
TYPES SUPPORTED, SEE THE ╙┼╘ ╞╔╠┼-╘┘╨┼ COMMAND EXPLANATION
IN THE ├OMMAND ─ESCRIPTIONS SECTION.
╘HE PROCEDURES FOR TRANSFERRING FILES WITH ╦ERMIT CAN DIFFER
WIDELY DEPENDING ON THE SYSTEM TO WHICH YOU ARE CONNECTED.
╘HIS TUTORIAL CAN'T POSSIBLY COVER EVERY POSSIBLE SITUATION.
╔NSTEAD, WE WILL WALK THROUGH A SIMPLE TRANSFER AND POINT
OUT SOME THINGS OF WHICH YOU SHOULD BE AWARE. ╘HE ═╧╙╘
IMPORTANT THING WHEN ATTEMPTING TO TRANSFER FILES WITH ╦ER-
MIT IS TO HAVE YOUR FILE-TRANSFER PARAMETERS SET CORRECTLY!
┘OU MAY WANT TO SKIP AHEAD TO THE ╘RANSFERRING ╞ILES SECTION
FOR MORE INFORMATION.
╬OW, WE WILL SHOW TWO EXAMPLES: 1) UPLOADING A ╨┼╘╙├╔╔
SEQUENTIAL TEXT FILE, CONVERTING IT TO STANDARD ┴╙├╔╔, AND
2) DOWNLOADING A ├ LANGUAGE PROGRAM SOURCE CODE FILE FOR USE
WITH THE ├ ╨OWER (NOW SOLD AS ╨OWER ├) ├ COMPILER FOR THE
64/128.
╨AGE 8 ├-64/128 ╦ERMIT ╒SER'S ╟UIDE
╘EXT ╞ILE:
╫E ARE SENDING AND THE OTHER END IS RECEIVING. ╔N NOTE
FORM, HERE IS WHAT WE NEED TO DO:
1) ├HECK FILE-TRANSFER PARAMETERS!! ═AKE SURE THE ╞╔╠┼-
╘┘╨┼ IS SET TO ╨┼╘╙├╔╔.
2) ╙TART ╦ERMIT ON THE HOST MACHINE USING THE APPROPRIATE
COMMAND.
3) ╘ELL THE HOST ╦ERMIT TO ╥┼├┼╔╓┼ THE FILE.
4) ┼SCAPE TO ├OMMAND MODE IN OUR ╦ERMIT (<├╘╥╠> - <┘> THEN
<"C">). ╘YPE ╙┼╬─ FOLLOWED BY THE FILENAME OF THE ├OM-
MODORE TEXT FILE YOU WISH TO SEND.
╫HEN THE TWO ╦ERMITS HAVE FINISHED TRANSFERRING THE FILE,
YOU WILL BE RETURNED TO ├OMMAND MODE. ╘YPE: ├╧╬╬┼├╘ AND
CONTINUE WITH YOUR LOGIN SESSION.
╬╧╘┼: ╘HE RECOMMENDED PARAMETERS (WORK MOST OF THE TIME)
ARE:
╞ILE TYPE IS ╨┼╘╙├╔╔
╞ILE BYTE SIZE IS ┼╔╟╚╘-┬╔╘
┼VERYTHING ELSE SHOULD RETAIN ITS DEFAULT VALUE.
├ ╨OWER ╞ILE:
╫E ARE RECEIVING AND THE HOST IS SENDING. ╔N NOTE FORM,
HERE IS WHAT WE NEED TO DO:
1) ├HECK PARAMETERS!! ═AKE SURE THE ╞╔╠┼-╘┘╨┼ IS SET TO
├-╨╧╫┼╥.
2) ╙TART ╦ERMIT ON THE HOST MACHINE USING THE APPROPRIATE
COMMAND.
3) ╘ELL THE HOST ╦ERMIT TO ╙┼╬─ THE FILE.
4) ┼SCAPE TO ├OMMAND MODE IN OUR ╦ERMIT (<├╘╥╠> - <┘> THEN
<"C">). ╘YPE ╥┼├┼╔╓┼ FOLLOWED BY THE FILENAME OF THE ├
SOURCE CODE FILE YOU WISH TO RECEIVE IN ├ ╨OWER FORMAT.
5) ╫HEN THE TWO ╦ERMITS HAVE FINISHED TRANSFERRING THE
FILE, YOU WILL BE RETURNED TO ├OMMAND MODE. ╘YPE: ├╧╬-
╬┼├╘ AND CONTINUE WITH YOUR LOGIN SESSION.
╬╧╘┼: ╘HE RECOMMENDED PARAMETERS (WORK MOST OF THE TIME)
ARE:
├-64/128 ╦ERMIT ╒SER'S ╟UIDE ╨AGE 9
╞ILE TYPE IS ├-╨╧╫┼╥
╞ILE BYTE SIZE IS ┼╔╟╚╘-┬╔╘
╫ORD SIZE IS ┼╔╟╚╘-┬╔╘
┼VERYTHING ELSE SHOULD RETAIN ITS DEFAULT VALUE.
╔F YOU HAVE PERSISTENT PROBLEMS WITH TRANSFERRING FILES,
DON'T HESITATE TO ASK SOMEONE FOR HELP. ┴LSO TRY ╓┼╥┬╧╙┼
DEBUGGING TO SEE MORE OF WHAT IS HAPPENING DURING TRANSFERS.
╦ERMIT IS VERY FLEXIBLE, BUT FLEXIBLE CAN MEAN COMPLICATED!
╫E NOW HAVE COMPLETED THE INTRODUCTORY TUTORIAL. ╘HE NEXT
SECTION OF THIS MANUAL, ╘ROUBLESHOOTING, MAY HELP IF YOU
HAVE SOME PROBLEMS USING ╦ERMIT. ╘HE ├OMMAND ─ESCRIPTIONS
SECTION DESCRIBES IN DETAIL EACH OF ╦ERMIT'S COMMANDS AND
WILL PROVE TO BE INVALUABLE TO SUCCESSFULLY USING THIS PRO-
GRAM. ╟OOD ╠UCK WITH ╦ERMIT!